home *** CD-ROM | disk | FTP | other *** search
/ CD Ware Multimedia 1995 May / cd Ware (Juegos) Epimundo.iso / WIN / VB_SYS / FIXDATE.ZIP / README.DLL < prev    next >
Encoding:
Text File  |  1994-02-16  |  4.6 KB  |  128 lines
  1.  
  2. INTRODUCTION
  3. ------------
  4. FSTAMP.DLL - A small DLL to allow you to change the date and time stamp of
  5. a file from VB or C/C++.
  6.  
  7. FSTAMP is FREEWARE, but remains the copyrighted material of Richard A.
  8. Esterling, All Rights Reserved, 1994.  Everything else is probably the
  9. copyrighted material of someone else.
  10.  
  11. Said author is not responsible for much of anything; certainly nothing
  12. having anything to do with YOUR computer.
  13.  
  14.  
  15.  
  16. HISTORY
  17. -------
  18.   Ver 0.02 - Previous version was written in Borland C++ 3.1 using
  19.     setftime function.  This function (or my coding of it) did not seem to
  20.     like double-digit months; i.e., 11 and 12.  It also kept confusing AM
  21.     with PM and would yeild results like 18:00 am.  Not knowing if this was
  22.     a problem with SmartDrv and setftime or what, I scrapped the Borland
  23.     version and rewrote the DLL in Visual C++ 1.0.  Since VC++ has no
  24.     similar function, I now use a REGS union and invoke DOS service
  25.     21h/57h using the int86() function.  To top it off, the DLL ended up
  26.     about half the size it was when compiled and linked under Borland.
  27.   
  28.   Ver 0.01 - Initial release.
  29.  
  30.  
  31.  
  32. COMPATIBILITY
  33. -------------
  34. As far as I know, FSTAMP.DLL is only compatible with DOS-based systems
  35. (running Windows) since a low-level DOS service is utilized to set any
  36. given file's date and time stamp.  If someone discovers information to the
  37. contrary, I'd appreciate being notified just for curiosity's sake.  This
  38. DLL should work with DOS 2.0 and above, Windows 3.0 or Windows 3.1.
  39.  
  40.  
  41.  
  42. INSTALLATION
  43. ------------
  44. Copy FSTAMP.DLL to your Windows subdirectory, or into the same directory
  45. from which you will be executing your program.
  46.  
  47.  
  48.  
  49. USAGE
  50. -----
  51. The declaration/prototype:
  52.  
  53.    For VB:
  54.       Declare Function FileStamp% lib "FSTAMP.DLL" (ByVal FileName$,ByVal
  55.          NewDate$, ByVal NewTime$)
  56.  
  57.    For C/C++:
  58.       int FileStamp(LPSTR fileName, LPSTR newDate, LPSTR newTime);
  59.  
  60.    where:
  61.       "fileName" is any valid path\filename of the file that is to be changed.
  62.       "newDate" is a valid date.  This parameter MUST be eight characters
  63.          in width.  In other words, do not omit 0's.  "1/1/94" is NOT a
  64.          valid date; "01/01/94" is.  The date you specify must be later
  65.          than 1980.  What character you use to separate the numbers does
  66.          not matter (01-01-91 = 01/01/91 = 01.91.91 = 01 01 91)
  67.       "newTime" is a valid time.  This parameter MUST be eight characters
  68.          is width.  In other words, do not omit 0's.  "8:15" is NOT a valid
  69.          time; "08:15:00" is.  Note that the time must be specified in
  70.          military time.  Also, while you are allowed to specify an odd
  71.          number of seconds, DOS only uses even numbers to record the
  72.          seconds of a filename, so your seconds will be rounded down to the
  73.          nearest even number.  What character you use to separate the
  74.          numbers does not matter (10:15:00 = 10-15-00 = 10 15 00)
  75.  
  76.  
  77.  
  78. RETURN CODES
  79. ------------
  80. FileStamp will return 1 out of 6 possible return codes:
  81.  
  82.    0 - No detectable error occurred
  83.    1 - newDate variable does not contain eight characters
  84.    2 - newTime variable does not contain eight characters
  85.    3 - Specified file could not be opened
  86.    4 - Internal function call to commit date/time change failed
  87.    5 - Specified file could not be closed
  88.  
  89. The errors are listed in "natural" order; i.e., the order in which they
  90. occur.  Therefore, an error of 5, while hard to fathom, indicates that
  91. everything else was successful except for the actual closing of the file.
  92.  
  93.  
  94.  
  95. EXAMPLE
  96. -------
  97. This zip contains an internal zip file called EXAMPLE.ZIP.  Unzip this file
  98. and load FILESTMP.MAK into VB for a functional example of how to implement
  99. FSTAMP.DLL with your VB program.  Or, you can just execute FILESTMP.EXE to
  100. see it run.  This zip file also contains the latest version (at the time of
  101. this writing) of THREED.VBX (07/16/93) since the example utiltizes some 3D
  102. panels from this VBX.
  103.  
  104.  
  105.  
  106. FEEDBACK
  107. --------
  108. I threw this together in one sitting with very little testing because I
  109. knew someone was waiting on it.  If you have suggestions or would like
  110. enhancements, please let me know using one of the methods described below.
  111. You might have to wait a week or two, but the price is right <g>.
  112.  
  113.  
  114.  
  115. ABOUT THE AUTHOR
  116. ----------------
  117. I'm Rick Esterling, a computer scientist for Boeing Information Services
  118. contracted to NASA at Marshall Space Flight Center.  I can be reached at:
  119.  
  120.     Rick Esterling
  121.     Three Cruse Alley
  122.     Huntsville, AL  35801
  123.     205-536-8568
  124.  
  125.     Internet: esterra@widget.msfc.nasa.gov
  126.          CIS: 73322,702
  127.          
  128.